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I. INTRODUCTION 

The potential of computer-aided instruction (CAT) sig 
today's educational environment is great and is growing 
steadily. With the accessibility of personal computers, the 
use of computer-aided instruction becomes an even more 
attractive option for the instructor. 

In the area of VLSI design, the use of computer-aided 
instruction is particularly worthwhile due to the increasing 
use Of computer-aided design (CAD) tools. The material in 
the lessons themselves is ideally suited to the CAI environ- 
ment, because in VLSI design part of the initial familiari- 
zation process is reccgnizing the shapes and colors as they 
are presented on a computer monitor screen. Also, use of 
these tools requires a considerabie amount of orientation 
before the student is able to use them for design. The 
classroom environment iS not ideal for teaching use of CAD 
tools. This orientation would be best, of course, if it 
could be done individually with one-on-one instruction 
involving the professor and the student, but even with small 
classes of students, this ideal situation is frarelv 
possible. A well constructed lesson using CAI can be nearly 
as effective as individual instruction. It allows the 
student to proceed at his/her own pace and at a time that is 
convenient for him/her. It frees the professor to answer 
more guestions from the rest of the students. 

Merractive though Ehis option 15, there can be difficuli- 
ties in developing a lesson that wili function in this envi- 
ronment. In any environment, of course, the instructor must 
be able to present the lesson material in aclear and 
concise format, but in a computer environment, this becones 


even more critical. Not only is the instructor generally 


not present to answer questions on the lesson material, but 
the man-machine interface can add to student frustration. 

The lesson or tutorial must be both useful to the 
student, and possible for the professor toa develop ina 
reasonable amount of time. Rather than attempting to 
combine text-editing programs and graphics production 
programs, and then finally having to develop a program to 
control the lesson structure, there are CAI authoring 
systems to lessen the arduous task of iesson production 
Without use of such a systen. 

The interest inCAI has been growing at the Naval 
Postgraduate School, for use in expiainitig CAD tools, as 
well as in other areas. After considering various authoring 
systems, LAW Naceu, 1984 NFS receivec copies of the 
Video/computer Courseware Implementation Systen (YC=S) 
produced by the University of Utah Research Foundation. 
VCIS possesses programs which enabie the author to produce 
text and graphics frames, and select videodisk or videotape 
frames. VCIS also provides the programs to build the lesson 
from these component farts. Once finished with constructing 
the lesson, the authoring system can be used to test, 
execute, and print the tutorial. Two tutoriais, which 
together exercise most of the functions of the authoring 
system, were created using the VCIS. 

An overview of the VCIS programs currently availabie is 
provided in Chapter 172 Chapter III is a tttorial on gem 
VCIS, which is intended to enable an author to create a 
Simple lesson. Chapter IV describes the two tutorials 


produced using the VCIS and Charter V evaluates the VCIS. 
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fie Lot VIDEO-COMPUTER COURSEWARE IMPLEMENTATION SYSTEM 


(¥CLS) 


Ae. HARDWARE 


The University of Utah Video-computer Courseware 
Implementation System can be used on a variety of micro- or 
Mini-~computers under several operating svstens. The mic1ro- 
computers currently supported are Sirius, Terak 8510a, 
zenith 2-100, IBM PC or XT and true IBM compatibles, Sperry 
imevac micro, and HP 9836. Current efforts are underway 
involving the Tandy 2000 and the MacIntosh. The VAX 11-750 
and the VAX 11-780 are also supforted. VCIS runs under four 
operating systems at present: Microsoft DOS Version 2.0 and 
later, Berkeley UNIX 4.2, UCSD Fascal, and dHP Pascal. 

Each one of the microcomputers iisted in the previous 
section needs 256K of memory to run VCIS. The combination 
of a hard disk and one or more disk drives makes file manip- 
ulaticn easier but is not necessary. 

An actual VCIS workstation consists of a microcomputer, 
or a graphics terminal, connected t0a minicomputer with a 
videodisc or videotape player under computer control. The 
station has either a 9" or 13" black and white or color 
Menetor or TV. If the microcomputer is an IBM PC, its color 
Capabilities may be augmented Ey use of the Tecmar Graphic 


Master color board, or the regular IBM board may be used. 
Be. PROGRAMS 
fe ont rogue tion 


The programs are as described in VCIS User's Guide 


2.0d and 3.0a. See [Refs. 1,2] for complete descriptions of 
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the commands. The following sections provide a brief over- 
view of the programs and use capitalized words to indicate 


use of a VCiSmeonnand. 


PPammem Day CAND DIE I 


a. Capabilities 


TEXTEDIT is the program used to create the text 
portion of a lesson. Lesson text can be composed of up to 
254 segments with up to 254 frames per segment. A text 
frame isa grid of 23 (vertical) by 80 (horizontal) (J¢hage 
acter positions. The 24th line of the frame is the command 
line. A frame is comparable tc a transparency whicr may be 
overiaid with another text or graphics frame. If the frames 
are properly constructed, the underlying frame or frames 
will remain visible. 

The number of colors available for background 
and foreground depends on the system. Eight backqzoumea 
colors and 16 foreground colors are supported. On systems 
without color, the background color is usually ignorea and 
the foreground colors are sometimes displayed with varying 
intensities. The background cclor is not saved as part of 
the text file, however, and has to be re-specified later in 
BUILDER. 

There are two complete 96 character sets avail- 
able with most systems (one with and one without under- 
lines). Another program, CHEDIT, provides the capability mee 
create additional character sets (one using Greek letters, 
for example). There are 255 possible text attributes (type 
of character, color of foreground, color of background) Siam 


which to form the working group used for a lesson. 


i 


db. TeExtP Entering’ or Changing 


Text 1s entered initially With the INSERT 
command. when the insertion is complete, it is <ACCEPT>ed 
or removed if undesirable with <ESC>. After text has been 
entered, it can be MOVEG or CELETEd or changed to a NE 
color or character set. As the text 1S entered or changed, 
the author must remember the difference hetween a space 
{using the spacebar) and a null-Space (using the cursor). 
Frames are like transparencies and a space appears as a bit 
of back ground color. Several frames can hbe merged together 
to create anew frame, again using the concept of irame 
imams LACENCY. 

At any time during the text creation, the author 
can VIEW any or ail earlier frames or any graphics frame. 
This feature makes it easy for the author to see how the 
text- and graphics frames combine together, as well as how 


the text alone is progressing. 
3. GRAFEDIT 
a. Capabilities 


GRAFEDIT is the program used to create and 
modify the graphics segments of iessons. Re with TEX 12D fae 
GRAFEDIT is divided into 254 segments, where each segment 
May contain up to 254 frames. The actual size of the 
graphics frame depends on the resoiution of the individual 
monitor. 

Eight to 16 colors are available depending uyon 
the system used. A different color may be selected for each 
of several options - ZONE (£111 large area), ie N Ey. Soe 
(fili small area), MARKER or BACKGROUND. These selections 
become the working set. The wcecrking set may be temporarily 
altered at any time and will revert to the original working 


set, following the completion of that particular commana. 
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There are up to nine pattern indices availabie. 
They range from solid through diagonal, vertical and hori- 
zontal lines to dots to a blinking pattern. The programner 
has the option to change the kind of pattern available. The 
size of the elements within the pattern does not change as 


an object is increased or decreased in size. 
b. Object Creation/Modification 


The basic unit of the graphics frame is the 
object. It can be created using one of the seven predefined 
graphics objects (line, circle, arc, bezier curve, Mather: 
fill or zone) or using other author defined objects. The 
object is created by moving the cursor to any point on the 
screen using a digitizer, keykoard or mouse. An object 
consists of groups of control points {a circle has “tie 
contrel points ~- the center and a point on the circle). A 
grouping starts when the first control point is entered and 
it ends when another option (LINE, ZONE, etc.) is chosen. 
The object can be modified at any time to any degree. The 
author also can use objects created on other frames, 
segments or files to create a new frame or object. As with 
TEXTEDIT, the author can overlay the current graphics itramne 


with any text frame. 
4. BUILDER 


BUILDER creates the actual lesson structure. This 
program orders the presentation of the text, graphics, and 
video frames previously created. It sets up the question 
patterns - what answers are alicwed or anticipated (right or 
wrong), in addition to responses for unanticipated answers. 

BUILDER segments are composed of video, graphics and 
text frames and may be of any lengtn, subject oniy to the 
amount of available room on the disk. A segment may cail or 


USE other segments. It may alsc call a larce "special" (up 
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to 10K words of code) ora small “special” (up to 6K words 
of code). "Specials" are Pascal programs written to add 
features not supported by VCIS. A special would be used to 
create a graph from a student's input, for example. 

A lesson segment is created by setting up various 
paths for a student to follow. Each decision point has 
various options availiable to the author. The student may 
continue directly, branch to a help segment, back up to view 
previous frames, or quit. The author must kave planned all 


options, as unfinished paths are not allowed. 


5. INTERP 


The lesson segments can be tested, oor used in their 
final form, by using INTERP. INTERP uses the options speci- 
fied in MANAGER to decide, for example, if student path and 
answers are to be recorded, or if backing up is allowed. If 
other segments are called (USEd) during a test run, INTERP 
will assume the segment was available and was properly 
executed, and it will continue. For testing purposes, 
INTERP requires the four files per segment created py 
Pur R (.GRAF, .~RUN, «PAG and .TXT). In the testing mode, 
INTERP provides tracing information on the monitor which 
Shows the segment and guestion that is currently being used. 
When the lesson is completed and INTERP is inthe final 
mode, the file MANAGER.DAT must be present. In the testing 
mode, INTERP uses only those commands written by BUILDER, 
but other options must be selected for the final run that 
MANAGER.DAT provides (options like allowing backing up or 
recording student path). 


6. HANAGER 


MANAGER is the progran that creates the file 
MANAGER.DAT used by INTERP. It also creates the list cf 


students who are allowed to access the lesson if passwords 


Ss 


are to be used. MANAGER holds the list of right, wrong and 
neutral replies used by INTERP when a random reply is 
needed. Student paths and anSwers are recorded in 


MANAGER.DAT zor ruture reference. 
Wee the 
a. LISTER 


LISTFRAM lists text or graphics frames. Out put 
may be to the moniter or to a princer-. A partial oa 


complete listing of text or graphics frames is allowed. 
lo (3918 )0) 20 se 


CHEDIT creates or edits character. sets. A 
regular size grid (10 dots high by 8 dots wide) and a wide 
Size grid (10 dots high by 16 dcts wide) are available. fhe 
regular size grid creates a character set of 192 possible 
Characters, while the wide size grid has a set of 96 


Characters. 
Ce LINKER 


The LINKER programs links one control segment 
with up to 8 additional segments. If a lesson has nore than 
eight segments, LINKER can be used as many times as needed 
doing no more than eight new segments at a time. If one 
segment has been changed, the whole lesson does not need to 
be relinked. Only the new segment must be relinked to the 


old lesson, where it will replace the older version. 


da oe OU PARE 


SCOMPARE provides the facility of checking 
possibie string combinations as used in BUILDER. This 
allows the author to see if wreng and right answers will be 


properly detected when entered Ly the student. 
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Co eo eeeer 


SELECT picks the video sequences for a lesson. 
The author uses SELECT to obtain the start and stop points 


of the sequence for later use in BUILDER. 


C. CONCLUSIONS 


With the basic VCIS workstation containing a micro- or 
Mini-~computer with a graphics terminal and an overview of 
the functions available under the authoring system, the next 
step is to create a CAI lesson at the workstation using the 
programs. Chapter III provides a tutorial which if used 
With the VCIS User's Manuals, wiil assist the author in 


creating a simple lesson uSing text and graphics. 
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Ti. USING VRS 


Aw. INTRODUCTION 


This chapter is intended to provide a basic knowledge of 
VCs. Upon completicn, the reader should be able to create 
a Simple lesson with basic text, standard (system) character 
set and simple grafhics. Explanations for all of the 
commands for a given program or all the options withina 
given command are not provided. See [{Refs. 1,2] for further 
details and expianations. The convention used here is that 
program names are compietely capitalized, while command 
names within a program have only the first letter capital- 
ized and are enclosed in guotation marks. Specific terminal 
keys are indicated by completely capitalizing the name of 
the key and by enclosing the name in "<>", 

The explanations are given in terms of an IBM PC with a 
Tecmar Graphic Master color board, however, usage on other 
computers is Similar. While VCIS permits use of the nouse, 
digitizer, or keyboard for command input, only the keyboard 
commands are given. 

The programs are presented in tne secuence that the 
author would probably use in creating a lesson, except for 
TEXTEDIT and GRAFEDIT which are interchangeable. The 
sequence 1s TEXTEDIT, GRAFEDIT, BUILDER, INTERP, LINAS 
MANAGER, and LISTFRAM. 


Be LESSON PLANNING 


Before attempting to use any of the VCIS programs, the 
author must determine the lessen structure. Lesson struc- 
ture starts with the overall structure - whether the lesson 


will be menu-driven or will be strictly sequential, Log 
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example. Lesson structure also includes the structure of 
mies, trame - if the frame is purely factual, or if the 
Student is asked a guestion on lesson material. 

VCIS allows the author tc ask guestions of various 
types. For example, the author may ask questions which 
reguire the student to do a numerical calculation, provide a 
string response or make a choice among author-supplied 
responses. In each instance, the author must determine a 
response to the three types of possible student answers, 
Merem are Cight, wrong Or unanticipated. Each anticirated 
right or wrong answer may have its own response. 

The text and graphics on each frame have to be edited to 
provide a clear and concise presentation of a minimum nunber 
of new ideas. Especially when both text and graphics are 
used, the author must take care to avoid a cluttered and 
crowded screen. While the lesscn can be structured to allow 
the student to back-up and review a previous frame, careful 
editing of each frame will minimize tais. A clear presenta- 
tion with unambiguous guestions will minimize the number of 


wrong and unanticipated answers. 


C. SETTING UP AND PROGRAM CONVENTIONS 


The system is booted up using the Microsoft DOS V2.0, 
with a system file that structures the use of the F7, fF8, 
F9, and F10 function keys for use as cursor control keys 
(up, down, lert, and rignt, respectively). Once booted, all 
of the programs described (excert MANAGER) will return the 
author to the operating system upon corpletion. See 
Appendix C for details on what disks are needed and on the 
logon procedure. 

Except where indicated, the author invokes a command 
Onaiy by typing the first letter (which iS Capitalized) of 
the command. No additional ENTER or RETURN keystroke is 
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reguired. A command is usually terminated with either the 
<DEL> (accepts the action of the command) or the <ESC> 


(usually aborts the action of the command). 


Do TEXLEDLD 


Vo dnitial steeds 


Before invoking the TEXTEDIT program, the author 
Should be sure that there is sufficient room on the diskette 
to save the file and its changes. This is done by using the 
Microsoft Dos command "dir<RET>". I£ no drive is specified, 
the default (Shown by the prompt "A>" or "BD>") is used. The 
directory of the other drive is checked, Without changing 
drives, by “dir b:<REIO") Won) di: ae ae The directo, 
displays files with their sizes, the date the files were 
last changed, the total amount cf space used, and the amouat 
of space remaining on the diskette. TEXTEDIT atseuee 
requires 118K bytes of space, while a sample file containing 
one segment with 68 frames, needs 64K bytes. 

TEXTEDIT is invoked by typing TEXTEDIT<RET>. eee 


first level command line {line 24 ) displays: 


SE SSS ee 
| Create Edit List 


en | 





"Create" sets up a new text file, while "Edit" is used for 
changing or adding to a previously created text file. 
"List" is used to list the files on the disk. If selected, 
"Create" requires a segment name. Segment names’ should 
clearly indicate their positicn and/or function within a 
lesson. The filename is specified at the end of the 
session. A new segment starts with frame number 1. WEdi te 
asks for the filename and when obtained (the file may reside 


on adisk in the other drive, for example), TEX TEDRS 
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displays information on the file and asks if the author 
wants to start a new segment. The information displayed is 
the number of segments in the file, the number of times a 
segment has been revised and the size of the segment in 
frames and blocks. The author decides whether to starta 
new segment by answering Y (Yes) or N {Nop- A positive 
response elicits a reguest for the new segment name while a 
negative response causes the system to ask for a current 
segment name. As in "Create", a new segment starts with 
frame number 1. A previously created segment starts with a 
new £rame with the next number (for example, if 31 previous 
frames exist, the next frame is 32). 


The command line for "List" displays: 


2 a a ee ee ee ee ~  e ee e 


ile 
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; ; | 

All Directory Font Graphics Fattern Text Remove | 
J 
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itemeconmands "All", "Font", "Text", and "Graphics" list 
those files of the types specified that reside cn the disk. 
"Directory" provides the authcr with the opportunity to 
change the directory name. "Fattern" attempts to match a 


pattern string against file names on the disk. 


2. Creating A Frame 





Once the new frame appears, the second ievel 


command line 1S: 


=< 7 = aaa ae 
Delete Yank Xchange New -- Adjust Move as a | 
| 


Keep Edit Copy Remove View -~- Page Grapnics ? <.> 
Mrdo Find Status “"List’' --— Mcve Tab -— Guit Gia > 


EF 


on 


As shownlh, the second level ccmmand line appears as three 
lines, andthe author cycles from one line to the next by 
use of the period <.> key. It 1S not necessary for a 
desired command to be visible on the command line for it to 
be invoked. A one line summary of commands is provided 
With <> 

TEXTEDIT is initialized with certain default 
values which are shown in Figure 3.1 and Figure 3.2. The 
character set, or font, is the one provided py the systen, 
which is Similar to most typewriter keyboards (no mathemat- 
ical symbols, for example). The default attributes are 
blue, red, purple/pink, light green, light blue, yellow and 
white foreground colors with black highlighting. The frame 
back ground is black. 

These default values can be changed at any joint 
during the text editing process. The author can view or 
change the default values by invoking "Status" (type "S"). 
The first screen of "Status" (Figure 3.1) has the command 


lire: 
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Segment_name Font Background Edit List Quit 


ooo een 


Ge ee 


—<—<—<—$—aed 
“"Segment_name" allows the author to change the current 
segment name. "Font" allows the author to name a new char- 


acter set other than the standard set which is listed as the 
default. The character set file must be available, either 
on the same disk or on the hard disk, or an error will 
OCG: "Background" prompts the author for the frame's 
background color (0-7) when invoked. The background color 
is not saved with the text frame and must be respecified 
later, when the text frame is used in BUILDER. "dake 
displays the total set of 255 attributes available (Figure 


3.2). The default values are indicated by asterisks. These 
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Figure 3.1 TEXTEDITI Status Screen 1 


Beta tbutes nave the nermal character set (no underlining) in 
Mme upper half oor the total set, witn the alternate char- 
acter set (with underlining) Phe the  petven Wager. oreleng 
attribute is displayed as a number with one of eight tLack- 
@eound colors and one of 16 foreground colors. Wiles vt 
displays the same information akout the current text file as 
would be displayed when TEXTEDIT was first entered. 

On the second screen of "Status", the cursor is 
homed on the first attribute in the upper left corner of the 
aeribute matrix. An attribute is selected or removed from 
the working set by moving the cursor to the desired position 
Meine the function keys F7=F10 and depressing <DEL> to accept 


Or remove that attribute. This new working set 1S not saved 
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Figure, Ss Z TEXTEDITI Status Screen 2 


with the text frame, and must be regenerated each time the 
file is edited. The author stops the attribute editing 
session with "Quit", which returns to the "Status" screen 
one, and an additional "Quit" is needed to return to the 


second level command line. 
b. Putting Text on the Screen 


The author selects the desired attribute for 
text input by cycling through the working set by holding 
down the <CONTROL> and G keys simultaneously. The second 
level command line then displays the current attribute. 
Text is placed on the screen by invoking "Insert" and typing 


in the text. The author must either type <RET> or 
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re-position the cursor at the end of each line as the text 
does not wraparound around the screen. There will be a beep 
(prompt) if the author attempts to put text past the end of 
a line. The author can put text at different places on the 
Screen by moving about with either the function keys, ora 
combination of <SPACE BAR> and <RET>. 

The effects of the function keys and that of the 
<SPACE BAR> are entirely dizferent. The function keys 
produce a null space, while the <SPACE BAR> yields a space 
made in the background color. This 1S important only when 
one frame overlays another, when what appears to be an empty 
area on the top frame is actually an opaque Screen. The 
best way to avoid any difficulties, is to use the cursor 
position keys when moving the cursor from one part of the 
screen tc another. Frequent use of "View" will check on any 
unwanted opaque areas. 

At any point during the insertion, the author 
May change attributes, by again cycling through the working 
set using <CONTROL> and G. This only affects future text 
and not that already flaced on the frame. Mistakes can be 
corrected by either backspacing (erases the text) oz posi- 
tioning the cursor with the function keys, and inserting the 
new/correct text or characters. The "Insert™ command ends 
with <DEL> (to save) and <ESC> (to destroy) changes. 


c. Viewing Other Frames 


When text and graphics will be combined later on 
the same lesson frame, the author must nake frequent compar- 
isons between the current text frame and its associated 
graphics frame or frames. The TEXTEDIT command "Graphics" 
starts by requesting the file name, then the segment name 
{only if there is more than one segment). Once the graphics 
file has been specified, the same file will be used if the 


"Graphics" command 1S again invcked, unless a different file 
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1s requested. Once the graphics file and segment names are 


known, the "Graphics" command line is: 





a 
Get Segment Clear Frame Next Previous <ACCEPT> <ESC> 


————————— a ee oe 


ee 





"Get" changes the graphics file specified when "Graphics" 
was first invoked. "Segment" changes the segment used in 
the "Graphics" command. "Clear" erases all graphics frames. 


"Frame" asks for a frame number and overlays that frame on 


the current text frame. "Next" and "Previous" overlay the 
next and preceding frames on the screen, providing thamma 
frame number has already been specified. The specified 


graphics frames are kept on the screen with the <DEL> xey. 
This also returns the author to the second levei command 
line. Once accepted (<DEL> key), the displayed graphics 
Irame or frames remain with the frame, until a "Remove" 
command is issued or until a rew text frame is displayed 
(for example, use of "Insert" createS a new text frame). 
<ESC> also returns the author to the second level ccmmand 
line, but the graphics frame or frames are cleared frcem the 
frame. 

The author can check for consistency of the 
position or the material ona line (useful for command 
lines) or wording of text, oor can merge frames by using the 


"View" command. "View" produces the command line: 








—————ee 
{segment name} Segment Frame Next Previous Clear <ESC> 
|, SACECEE I> 
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Initially, the current segment name is displayed on the 
command line. This may be changed with the commana 


"Segment". "Frame" requests the frame number within the 
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Named segment to be overlayed on the current text frame. 
"Frame" and "Segment" prompt the author for a number and a 
name, respectively. "Next" and "Previous" display the next 
and preceding frames if a frame number has been selected 
earlier. "Clear" removes the overlayed frame. SONG (Saree 
(the <DEL> key) merges the overlaid text frame or frames 
with the current frame, and returns the author to the second 
level command line. <ESC> alse returns to the second level 
command line with the viewed frame or frameS remaining on 


the screen, but without merging them with the current frame. 


d. Ending the Frame and the File 


When a text frame is completed, "Keep" is 
invoked. it is not possible tc progress to the next frame 
unless the current frame has been kept. Wnen a frame has 


been xept, TEXTzDIT cycles to the next frame, and the text 
creation process repeats. 
When the author types "Quit", the command line 


becomes: 


(a - Cr se ee 


Save Discard Return 


"Save" asks for a text file nane. The author is frompted 


| ee | 


With the name of the current text file, if there is one. If 
the author hits <RET>, signifying that the current text file 
Name is to be used for the changed text file, TEXTEDIT asks 
if the previous version should be replaced. There are no 
difficulties with replacing (writing over) the oprevious 
fade "Discard" destroys any changes made during the 
session, and the prompt asks if the author wishes tec reccn- 
Sider the decision to discard. NRELWED =COutinues the 
TEXTEZDIT session where it left cff. 
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3. Changing Text 


Text frames can be modified at two different times, 


before and after a given frame has been kept. The actual 
changing process is the same fcr both. A section of text 
can have its attributes changed using the "New" command. 
Either before or when "New" is invoked, the author cycles 


the working set of attributes to the one desired, using 
<CONTROL> and G pressed simultaneously. The new color must 
be the one used for the command line when the marking proce- 
dure of "New" commences. Only cne color can be changed at a 
time. Tf several new colors must be changed, each isa 
separate invocation of "New". When "New" asks for the uprfer 
left corner (which is under the upper left character or 


space), the author positions the cursor in the proper posi- 


tion and hits the <DEL> key. The lower left corner is 
defined in the same manner. After the change is. on the 
screen, the author is asked if the change is acceptable. A 


<DEL> keeps the change, and <ESC> aborts the change, and 
both return the author to the second level command line. 

"Insert" is used to insert characters. As described 
earlier, "Insert" does not wrap around, and ends with <DEL> 
Obaaosco. "Delete" removes the character to the right when 
the <SPACE BAR> is used, and the rest of the line when <RET> 
is used. Backspacing restores a deleted character. The 
deletion process, as with "Insert", ends with <DEL> om 
<ESC>. "Xchange" exchanges character for character and ends 
With <DEl> wor <b Se. As with "Delete", backspacing returns 
the exchanged character to its criginal value. 

To repoSition a block of text on the frame, the 
"Move" command is used. The author is asked to mark the 
upper left corner, then the lower right corner of the block 
to be moved. AS with "New", the cursor position for each 


corner is under the respective corner or space. The next 
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question from “*Move"™ asks for the upper left corner of the 
destination postion (under the character), again marked with 
DEL « The command's actions can be aborted at any time 
meen <ESC>. If the moved text extends outside the [rame's 
edges, the author is informed and is asked if the nove 
should be done. A poSitive response destroys the over- 
hanging portion of the text. BiOve SS aiomecr tM nated aay 1th 
either <DEL> or <ESC>. 


E. GRAFEDIT 


1. Initial Steps 


Before invoking the GRAFEDIT program, the author 
should be sure that there is sufficient room an the Gisxkette 
to save the file. GRAFEDIT itself requires 137K bytes, plus 
2K for the NOMOUSE program. Fer example, a one segment, 37 
frame graphics file takes up 47K bytes of space. 

GRATED I teers 2nvVOked by typing GRETEGCRET>. The 


[iewesoe Level command line is: 








omens ond 


As in TEXTEDIT, "Create" asks fcr a Segment name, starts in 
Frame 1 and names the file at the conclusion of the session. 
Segment names should clearly indicate their postion and/or 
function within a lesson. DPeSO dss ti tox bedi, bait" vasks 
for the file name, then displays the same sort of informa- 
tion on the file as described under TEXTEDIT. The author 
then either chooses to start a new segment or picks a }[revi- 


ously created segment. 


PES, 


2. Creating a Frame 


Once the new frame appears, the second level 
command line is; 
= st St 
| Create Edit Draw Modify Remove Keep Get View Help Stat 
Kk Text soni t< 


ee eee 


has wee 


Most of the second level commards are exvlained 
later in the order that the author would probably use then - 
starting with "Status", "Draw", “Create", "Get", (seam 
"Keep", "Edit", and todas 


The remaining two commands are "Heip"™ and 
"Remove", "Help" displays a frame containing one line 
descriptions of the second level commands. "Remove" 


displays the command line: 





(i. ¢ t3" > - eC en annem 
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Graphics All Unused Object Ncthing ? Esc 


| ae Eee ee eee 





"Graphics" removes only what has been drawn on the screen, 
while "A111" deletes both what is on the screen and all 
objects, used and unused. "Unused" removes those objects 
not used in what has been drawn on the screen. "Obj Jecu. 
displays a numbered list of all the objects on the frame and 
the author 1s prompted for the number of the object to be 
removed from the list. For each of the previously described 
commands, the author is asked to confirm that the item or 
items specified are to be deleted. "Nothing" and “seul 
escape "Remove" without deleting anything. we" is the hee 


command and was not available on version I1II.0a of GRAFEDI?. 
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GRAFEDIT is also initialized with certain 
default values which are shown in Figure 3.3. The author 
invokes "Status" to view or change the default values. The 


default values are white solid line, white 


“Currene. Fite: 





Pigure 3.3 GRAFEDIT Status Frane 


Serta zone and fill, white small dot rarker, and black Eack- 
ground. Other default values with which the author may be 
concerned are the arrow skip value ("Ju"), which can be set 
meom I-255. AeRDOUNdAG yo § Ba) eewaten 15 .used an “Fili', 
can be either any line or be of the same color as the "Fill" 
GOLOL. Zoom ("Zo") can be done by a numerical scale value 
SeebyY position. Rotation ("Gr") can be done by degrees or 


by position. On those items in “Status" where there are two 
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possibilities, (WZeon"; for example), invoking the iten 
toggles@thne cvesumes 

Colors are changed by invoking "Color™ index 
and then typing in the number cf the desired color (0-15). 
The selected color appears in the left-nost box (iabelied 
Current Color) in whatever the current pattern index is 
(default is solid). The new color is transferred to "Line", 
"Zone", "Fill", "Marker" and "Background" by positioning 
cursor in the appropriate box and hitting ~<DELD- The 
"Pattern" index is also changed in this same way. The 
author selects "Pattern", then the index number (0-9), and 
moves the new pattern to the right area. The "Line" style 
is changed in much the same way by entering "Line" and taen 
the style number (0-7). "Keep" saves the "Status" values. 
If the "Status" values are not kept, those changed values 
Will only be maintained for a continuous session ("Quit" or 
"Discard" stops a session). There is only one "Status" 


board per file. 
3. Creating an Object 


As explained in Chapter II, the asic unit ofa 
graphics frame is an object. Cbjects are created using the 
seven system primitives (line, circle, arc, etc.) or other 
objects. The author starts the creation process by invoking 
"Draw" on the second level command line. 


The Draw command line is: 








Se 
| Lin Bez Mrk Zon Fl Cir Arc Okj X + — ? Gre Sty Rel Del 


i Ver Esc Quit 
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See [ Refs. 1,2] for complete descriptions of all commands. 
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a. Example Orject Creation 


Figure 3.4 showsS a Simple arrangement of three 
boxes, a circle, and several dcts. The order in which the 


objects are drawn on the screen is the same order which is 


used each time the frame is tilater displayed. Oe ans 
possible to modify the drawing order later, 1£ the author 
determines that the criginal order is incorrect.) Oc. Gain 
these shapes, the author selects "Cir" (circle) and is 


BPeometed <~Or the center point, and then for a point on the 


errec le. 





Figure 3.4 Sample Prame 
These points are entered by positioning the cursor with the 


function keys and hitting <DEL>. The circle is drawn in the 


mOLOr Specizied in “Status” for lines. 
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The open box is formed by selecting "Lin" 
(Line). It can be drawn in two different ways. The picture 
on the screen is exactly the saze, but one metnod results in 
four groups, and the other in one group. The former nethod 
positions the cursor on one vertex, enters the point using 
<DEL>, moves the cursor to the next vertex, again entering 
the point with <DEL>, and then re-selecting "Lin". Tags 
process 1s repeated three times (except for the last step of 
the third iteration). This results in four groups of one 
line (side) in each. The other method starts in one corner, 
enters the point with <DEL>, and then moves from corner to 
corner, entering the point each time with <DEL>. Takes 
results in one group with four lines in it. fhether the 
author chooses to use one methed or another depends on the 
amount of later changes that may need to be made. The box 
made of four groups can be modified side by side, while the 
other box made of one group, can only be changed as a whole 
unit. 

The third object to be drawn is done by 
selecting "Zon" (Zone). The author moves the cursor to one 
corner of the zone, enters it using <DEL>, moves to the 
diagonally opposite corner, and enters it with <DEiee 
completing the zone. A large zene (about 1/4th of a screen) 
Can take an appreciable amount of time to draw and prokably 
should te avoided. 

The third rectangle 1s a box created by drawing 
lines and then filling it with a pattern of diagonal lines. 
The box is drawn as previously described, then the author 
selects. “WFIMs(Falijr The cursor 1s moved to any point 
inside the box and entered using <DEL>. The box is then 
painted with the selected fill fattern and color. The {fia 
proceeds until it encounters the boundary condition. This 
condition can either have the filling stop at a boundary of 


the same color as the fill, or at any boundarv. The author 
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could inadvertently fill the whole screen if the wrong 
boundary condition had been set, or if there is a break in 
the boundary. "Fill" is slower than "Zone", and therefore 
Should only be used in small areas (1/16th of screen or 
less). 

The final group onthe frame is a series of 
markers. The author selects "Mrk" (Marker) and then enters 
dots point by point with <DEL> (moving the cursor between 


points, of course). 
b. Changing Styles 


Tf the author needs to change the color ofa 
line, perhaps for drawing the box that was filled in the 
example, this can be done ona temporary Ddasis by using 
Mey" (Styie). The Style command line is: 


EE <n ee SS EE SS EE EY RE 


Color Index Default Mode Pause Ver ? Quit Esc 


ee pete SS 





When "Color" is selected, the color spectrum (as in Status) 
appears, in whatever pattern or style index is the Current 
Color as specified in "Status", temporarily replacing the 
command line. The author moves the cursor to the desired 
color and enters it using <DEL>. This does not afiect the 
color kept in "Status" and the new color lasts oniy until a 
new option has been selected or uatil "Draw" has been 


exited, whichever comes first. 


ce. Additional Considerations 


If the last action iS a nistake, filling the 
whole screen, for example, "-" deletes the last object 
drawn. "+" will put back what "-" erased. 

The principle for using "Arc" and "Bez" (Bezier 
curve) are Similar to "Line", "Zone", etc. Bezier curves 
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require much practice in placing the control points properly 
to produce a recognizable and smooth curve. 

At this point, the author may wish to make modi- 
fications in what 1s on the frame or to make it an object. 
This can only be initiated on the second level command line. 
"Cuit" exits "Draw" and returns the author to this second 


level. 
d. Naming the Object 


At the second level, selecting "Create" provides 
the author with the opportunity to name the object. The 


"Create" command line is: 


"Object" asks if the current frame should be made into an 
object, andif yes, the author must provide a name ror the 
object. Names should be unique, descriptive and compiy with 
the naming conventions of the operating system (not more 
than eight characters long, etc.). 

The author couid have started the whoie above 
process by naming the object, then drawing it, rather tnaan 
as described. Selecting "Create", "Object" and then drawing 


the object, would have the same result as presented above. 
4. Making a Frame 


A frame is created either with namec objects or by 
drawing the frame as a whole. "Create" frame is the default 
state for GRAFEDIT. The author is placed in that state upon 
entry to GRAFEDIT or after a frame has been saved. 

The objects used on aframe can either be ones 
existing on that specific frame, or can be located on 


another frame, or in another file. This concept of a 
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storage or library frame is very useful as objects need not 


be constantly re-created. The author obtains objects fron 
other frames by the "Get" ccmmand on the second level 
command line. "Get" asks for a filename, and a segment name 


if there is more than one segment in the file, thea displays 


the command line: 





irs ccomietertS Cnr ee vere 


Getfile Info Frame ? Quit 


Smee ees oa 
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"Getfile" re-starts the process of getting a graphics file. 
"Frame" prompts the author for a number within the srecified 
segment. After the frame is displayec on the screen, the 


command line is: 


i ea a = eae eel ae a Se ee ay ee eS ne gee 
Object All_objects Merge Next Prev Getfile Info Frane | 
mee CULT 
Oo 
"Object" shows the author a list of the available objects 
and the author selects one by typing first "Number", then 
the object's number. "All objects" takes all the objects 
Tesiding on the frame, while "Merge" takes the objects and 
the frame. Whatever has been selected, whether an object or 
a whole frame, is merged with the current frame. If some of 
the new objects have the same names as ones or the current 
frame, the author is advised of this, but as the objects are 
given unigue numbers on the object list, nmothing is lost or 
destroyed. The new objects are added to the end of the 

@pjyect list. 
Once the needed objects have been obtained, the 


author makes the frame by invoking "Draw" and then "Object". 
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The "Object" first Hevel connand Line wee 
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Use Copy ? Esc 
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"Use" displays the list of named objects with an asterisk 


beside those that have not yet been used, and the command 
line: | 
eee eS a a 


Choose an object: Number ? Esc ' 
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If there are more objects than can be displayed in one 
column, "More" appears on the command line, and selecting 
it, cycles the object list to the next column of nunbers. 
The author selects "Number", then types the humber of the 
desired object. When the "Draw" command line re-appears, 
the object name 1S written one line above it at the left 
side of the monitor screen. The object is placed on the 
frame by positioning the curscr and hitting <DEL>. The 
actual object poSition will have the same orientation to the 
cursor as it had to the center of the frame when created. 
The author can either draw all the objects in the same 
Manner, and then modify them to create the complete frame, 
or each object can be modified trefore drawing another. The 
latter method is especially useful when objects have been 
created and stored as a fuli screen version, but which wii 


be used in a reduced size versicn. 


5. Viewing Other Frames 


AS mentioned in the section on TEXTEDIT, the author 
needs to make reference to the associated text frames to 
ensure proper ofject placement. This 1S accomplished at the 


second level coumand line with the command "Text". Tf no 


text file has been specified in "Status", the prompt asks 
for the file name and the segment name (if more than one 


segment is in the named file). The "Text" command line is: 


Getfile Segment Clear Frame Next Previous Quit | 
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The explanation of these commands is the same as for viewing 
graphics files from TEXTEDIT. 

The author may wish to see other graphics frames or 
objects. This is done by using the "View" command on the 


second level command line. The "View't command line is: 


rai ae ee eS a a a ee ee 


Local_object Names Frame Object Current_frame Esc 


a ee eee ie ee Se eee ee eee oe oe 
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"Local object" aliows the authcr to view objects from the 
current frame, while "Object" allows the author to view 
objects on a different frame. "Frame" displays a frame fron 
the current file or another file. "Names" displavs object 
names and allows the author to change an object"s name. 
"Current_frame" re-displays the current frame. 

ASawi thee TOK LTEDET “the author must first “"Keerp™ a 
frame, in order to proceed to the next frame. If some 
objects were unused on the frame, the author is asked if 
they should be kept. The author exits GRAFEDIT by typing 
“Ouit™ on the second level command line. Seis LEXT EDIT, 


the command line now is: 


ee ae a eae ee eo a a SS SS 
Save Discard Return 
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"Save" will keep the changes, and as with TEXTEDIT, it is 
acceptable to use the same name for the changed fiie as for 


the original one. 
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Editing is initiated from the second level 


command line. The "Edit" command line is: 


a aaa ETRE IEEE TET TIL aps. =2=#=+=*=*~*~*~<CS 
| | 
| Frame Object Name Esc 
"Edit Frame" will change an existing frame, either in the 
current file or in another file. Editing a frame means 


modifying the objects or groups that compose it. This first 
level of editing uses the highest level of objects on the 
frame. So if objects were used to create other objects 
before being drawn on the screen, only the outermost layer 
of objects will be available when "Edit Frame" is selected. 
The only changes are to the various objects as complete 
entities. That is, change in size or orientation of a whole 
object is possible, but not changing tne color or size of 
any object that makes up the high level object. The author 
can edit an existing frame, then edit an object on that 
frame. "Edit Object" operates on objects in the current 
frame only. Once edited, alluses of that object on the 
current frame reflect the changes. "Edit" only changes game 
State away from "Create", the actual changes are accon- 


plished through "Modifv" or "Draw". 
b. Modifying Commands 


The Modify command line is: 











a 
| 

| Move Rot Ext Zoom Sty Fir Last Bfore Del Win + - ? xX | 

Undo Add Ver Quit 

| 

| 
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When Modify is invoked, the current object or groufr is 
displayed to the left of the monitor screen onthe line 
above the command line, and its control points are higa- 
lighted. The author can cycle through the objects or groups 
mee COMpOose the frame or object by using "+" or "-", 


An object or group can be moved from one posi- 


tion tc another by using "Move", The first point required 
is the origin reference point. The second one gives the 
direction and distance of the move. The object is moved 


with respect to its position abcut the origin point. 


Objects or groups can have their orientation 


Shifted by using the "Rot" (Ffotate) command. trotate! 
requires either three points cr two points anda degree 
amount. The first two points for either method set the 
origin andthe reference line. The third point or the 


amount sets the degree of rotation. 

Once the desired object or group has been 
selected, the author can change the size by using "Ext" 
(eeeeend) or “Zoon". "Extend" stretches the object cr group 
in the specified direction by the specified scale factor. 
NExtend"'s scale factor requires three points: the first is 
the anchor, the second sets the unit distance and the direc- 
tion of the scaling, and the third gives the scale factor 
with respect to the anchor point. "Zoom" scales the whole 
object or group by the specified scale factor (a shift in 
two dimensions). After either of these two commands is 
selected, the author is prompted for the necessary values. 
The scale factor can be entered by position or by number. 
porn “Extend” and "Zoom" require an anchor point and a 
second point to determine the unit distance. The method for 
determining the scale factor is that specified in "Status" 
"Zo" on "Status" command iineé). "Position" requires a 
third point to set the scale, while "Value" provides the 
actual scale factor. The methcd is previously selected in 


"Status" ("Gr" on the command line). 
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A group's attributes can be changed by using 
"Sty (Styteye The method is the same as was described for 


changing the style in "Draw". 


"Del" (Delete) renoves the current object of 
group. "Add" replaces what "Delete" erased. "Undo" erases 
the last change. The author returns to the command line by 


ty Payne OC uneease 


F. BUILDER 


1. Sebleeure 


Lesson construction in BUILDER revolves around the 
concept of a path and its branch points. A path cane 
strictly linear with no branch points (Similar to reading a 
book from cover to cover), or it can bave branch pointSeaag 
offer many choices {like a "tree" structure). The 
complexity of a path increases in direct proportion to the 
humber and type of branch points. A branch point is a place 
in the path where the student is required to make a choice. 
The choice can be in response to a guestion on the lesson 
material, or it can be a choice on what material tne student 
Wishes to see (choosing to use a Help segment, for example). 
Each path must end in one way or another, orf an error or 
ambiguous Situation results. Paths may end by jumping to a 
label ("GoTo"), "Join"ing the next step, "Halt"ing (ends the 
lesson session ), "“Exit"ing (ends the lesson segment ), or 
"Repeat"ing the decision point (Figure 3.5). 

This section will explain how to build two different 
structures: a menu or control segment (Figure 3.6) anda 


Short called segment (Figure 3.7). 


BUILDER 1s invoked by typing BOUMEDSR<RED. The 


author must ensure that sufficient space iS available to 
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Clear Text 


Figure.3.5 Examples cf Path Terminators 


meoeee the four files that BUILDEX creates {.aUN, .TXI, .PAG, 
pence « GRF) . BUILDER itself reguires 143K pvtes of Space. 
For example, a Short four frame iesson with no graphics 
reguired 8K bytes of space, and a menu witn eight callieé 
segments needed 16K bytes. 


A text anda graphics file are needei to create a 


BUILDER lesson segment. PVeneiiwtnewjrd piics “Lille 15) 2ot 
needed, BUILDER allocates 8K opytes despite having n10 
Meagpnics in it. It is, therefcre, wore space efficient to 


Mawes a Graphics Lille, even if it 1S not used in the lesson. 
Mmeectext and graphics files reguired for BUILDER will prepo- 
ably not fit on the same diskette as the BUILDER program and 
the four lesson files. 

A BUILDER convention reéeguires tnat the lesson name 
and the segment name be the same. The lesson name 1s what 
wili be the fiie name with the four extensions mentioned 
above. The segment name is what is referenced by calls 
within the lesson. 

Once BUILDER has been invoked, Pie far st Eromet1s 
£or the lesson name. Tf a desson of that name aiready 


Persts, the author is asked, in turn, if each of the four 
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| | 
| * Use Introduction | 
| 
* Display Menu Text Frame | 
| 
| *> Stact (Point | 
| 
| * Student enters data and Comparison | 
| 
| | | | 
| a 5 C d = Default | 
| | | | | | 
Use Use Use Use Halt Repeat | 
| Suoject A Practice A Subject 8B Practice 8 | 
| | | ! | 
| Display Display Display Disolay | 
Menu Menu Menu Menu | 
Text Frame Text Frame Text Frame Text Frame | 
| | | 
| Repeat Repeat Repeat Repeat { 
| | 
| 
—— ee 
Figure 3.6 Menu Segment 
lesson files should be replaced. A negative response wiil 
result in areguest fora new lesson nhame. The second 


prompt is for the segment name, which should be the same as 
the lesson name. The third and fourth requests are for the 
text and graphics files, respectively. Tf either has amore 
than one segment, the segment name is requested. 


The first level BUILDER command line is: 


(aia ee 
Branch Clear Display Remember Use <.> 
File Status Wait View Prompt Quit <.> 





44 





Display-Text frame 
Prompt student by flashing 


Display-Graphics frame 


Ciear-Portion 


Wait for student to type any key 


x — *&— *— eH KK 


- 
| 
| 
| 
| 
| 
| 

Wait for 10 seconds | 
! 
| 
| 
| 
| 
| 


mevct. 2: p. 2), 


Figure 347 Called Segment 


The period, <.>, toagles the command line. Most commands 


Gane be aborted, once invoked, by <ESC>. 


fe 2uildi ag a Lesson 


== a ee ee qe Se SS SS 


eae oe tk UD 


Before the lesson building actually beyins, tne 
aienor May need to alter the default values in BUILDER. 
"Status" displays the cCefault values (Figure 3.8). Tne 


Paeatus'" conmand line is: 


a ae ae ee ee Se he ie ee et eee 
; , | 
} Text Graft Char Accur Upper hait Field Delay Note Back | 

exat | 
Pmenenmcioned ih TEXTEDIT,  BULIDER contains the background 
color specifications. Licmmc lULOn Canmcmange themecolor by 
selecting "Back" (Background), and typing the number (0-7) 


of the desired color. The default color is black. 
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Ne _— —— = — - es A ca _— _—_ = — 


Tec (filename } 


segment (segment name} (#) (# of frames] 
Gras | filename | 
segment (segment name} (#) (# of frames} 
Character set *System 
Accuracy 3.00 : Rigznt Concer: Of8 
Uppercase True wrone Cetinter: OFF 
Walt <Any kKey> 
Delay 0.00 Memcry left: 7980 
Fields O questions incomplete 
Answer 4 
EGne 4 
Note Unused labels: 
Frequency 350.00 ABC DEE GH | J Kae 
Duration 0.33 NOP QR S Tf JUN Wee 
Test Undefined labels: 
Background 0 
Set lapels: 
0 1 2 3 4 = 6 T 8 fc) 10 ial 2 13 14 


Main STATUS: Text Graf Char Accur Upper Wait Fleld Delay Note Back Exit 


| [Ref. 2: p. 53], 


| 
ee 


Figure 3.8 BUILDER Status Board 


WAGEUE” “Accubacy is measured in percent wrong and ranges 
EEO Cc Oem It refers to the student's response or 
choice at a DBbrancn foint of aitenmvay cies mien "Note" has 
the frequency in Hz and time of the prompt duration in 
seconds. The "Freq"uency rangé 1S 0-20 KHz, and the note 
"Dur"ation is 0.034-60.0 seconds. “Exit™ returns the aueigee 
to the first level command line. 

During tne lesson, the author can, and should, 
enter "Status" to check which labeis have been properly set, 


and which have been used without peing defined. Undefined 
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ljabels result in undetermined paths, or in other words, an 


error. 

b. Displaying and Clearing Text and Graphics Franes 
Generally it is a good idea to both begin and 
end a segment with a clear screen. This avoids inadvertent 

overlaying of frames. "Clear" has the conmand line: 
| A | 
Text Graphics Both Answer Refly Counter | 
ean an ee 


The "Clear Text" and "Clear Grafnics"™ commands are used when 
only the text or graphics portion of a screen need to be 
erased. Text clearing is done line-by-line from top to 
bottom, and so is rather slow. "Clear Both" is faster than 
"Clear Text" and can be used even if there are no graphics 
present on the screen. 

Text and graphics are put on the screen using 


the "Display" command. The "Display" command line is: 


EE  — 
Text Graphics Echo Counter Reply Video 


| 
| 
a a a 


Both the "Text" and "Graphics" commands, when invoked, 
display the range of frames present in the specified segment 
and request a frame number. When the requested frame is 
displayed, the author must confirm that the frame shown is 
the one desired. If it is net the right frame, another 
frame can be requested at that time without leaving "Display 
fem or “Display Graphics". 

Text and graphics frames may be overlaic to 
create the lesson frame. The order in which they are 
displayed is totally dependent on the text and craphics 


frame composition. Overall, it is probably better to show 
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text first, as it is displayed more rapidly than grapniece 
and the student has something tc look at aimost immediately. 
Use of text labelling on graphics frames, however, usually 
requires that the graphics be displayed first (labelling of 
inputs, outputs, ground and power in a circuit diagram, for 
example). Often labels are overlaid directly on figures, 
and due to the opacity of VCIS frames, the seguence must be 
graphics, then text in order for the text to be visible. 
Once disflayed, the text and graphics should 
remain available for the student to read for a certain 
period of time. This period cf time may Lte set by use of 


MWait". The "Wait" command line is: 





a 


Default Any_key Frame Key System Tine 


——— 


"Aany_key", "Key", and possibly "Default" (depends on what 
"Default" has been set on in "Status"), require the author 
to specify aocursor display pcsition. The bottom fright 
corner of the monitor screen displays the line and column 
number of the cursor position. "Key" has the author select 


any one key that the student must depress before the lesson 


continues. "Time" sets a pericd of time from 0.1 to 2300.0 
seconds. This is most useful in displaying the logo or 
title frames. "System™ is similar to “Any_key" and "“Keyvim 


It uses <SPACE BAR> and does nct reguire specification of a 


cursor display position. 
c. Using a Lesson Segment 


One way to minimize building complexity, and to 
ease editing or modifying of lessons, is to split long 
lessons into segments. This is also useful in creating Help 


segments and in menu structures. 
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The "Use" command line is: 








a PS ae ca = rel 

Graphics Text Special Lesson Segment | 
(Eee J 
"Graphics" and "Text" store frames for use in a "special" 
lesson segment. "Special" calls a Pascal program written by 
the author to supplement VCIS. "Lesson_segment"™ prompts the 
author for the segment name. This can be used to calla 


Help segment or as part of a menu Structure, where when the 
student selects a certain option, the result 1S a call (use) 


of a lesson segment (see Figure 3.6). 
d. Branch Points 


The actual structure of a lesson is Getermined 
by use of various branching technigues. Only selected 
branching instructions will be explained in depth here. See 


[Ref. 2] for further details. The "Branch" command line is: 


(see ee ee 
Keyboard Counter Memory - Lakel - GoTo Exit Halt Join 
Repeat 


ee 


"Keyboard", "Counter", and "Memory" define where the deci- 





Sion information on a branch is_ to be obtained. The other 
Six commands are either path terminators, or are used in 
path termination, and are explained later. 


The "Keyboard" command line is: 


ina: Sri eo i i Aaa nats: ge te ee ee 


Answer Character Position - Timeout 


— 


— a rd 


“NAnswer" first has the author select the area of the monitor 


screen where the student enters his/her response. Tires leit 
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edge of the space is selected first, (using the function 
keys to move the cursor and <DEL> to select it), and then 
the right edge. This space may be at most one line londa. 
The column and line fosition of the cursor is displayed in 
the bottom right corner of the screen. The type of "Answer" 
that may be put in that space is selected from the command 


line: 


aE EERE TIENT IT CO tsts—S 
Neutral Right Wrong Unmarked - Switch 


 ——— ee ee 


Selection of "Neutral", "Right", and "Wrong" requires 


construction of a path. The next command iine is: 





Sarina anEiinaeieteeeniantttiemeatetiatemamemeememmT 


ee: nee 
| String Pattern Numeric Missirg Jnanticipated 


a 





The author must build the expected answers, whether right, 
wrong, or neutral, first, before doing the unanticipated 
answer. The unanticipated response is used as the default 
and must be constructed last. 

A “String” answer is composed of up to 7/5 ¢raime 
acters, which may include the lcgical operators AND (&), OR 
(9 rand NOT eK: Sample strings can be tested using SCOMPARE 
(before or after BUILDER session) to verify a natch. 


Choosing "Keyboard Position” is useful in 
creating a menu structure. The author must first mark the 
cursor display positicn using <DEL>. As with "Answer", the 


next ccmmand line is: 





co +--+ 


— P| 


: 
| Neutral Right Wrong Unmarked - Switch 


L 


"Neutral", “Right, and "Wrong "sais | eadmaror 
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rr. re ne ee ee 
Anticipated Missing Unanticirfated 


a a a ae a a ee | 


"Anticipated" has the author mark (with <DEL) first one 
corner and then the diagonally cpposite corner. 

Once the corners are marked or the string is 
specified, the author continues the path that that partic- 
ular student response has chosen. RemcntS point, Senne oa th 
May use a segment, display text or jgrapnics frames, etc. 


The path ends with ancther invocation of "Branch". 
e. Path Terminators 


Path terminators are selected from the "Branch" 


command line: 





; j 
| Keyboard Counter Memory - Lakel - Goto Exit Yait Join | 
Repeat | 


"Halt" is only used to terminate the lesson session, while 
"Exit" is used to end a lesson segment. "Goto" reyuires a 
label to which to branch, and "Label" sets this point. jine 
an author wants the student tc see a certain frame, the 
label should be placed before the frame is displayed. The 
student wili not see the frame, if the label is defired 


after the frame has been displayed, even though the clear 


command has not been issued. WO aor Ly icOntInues Chito 
the next command after the branch point. "Repeat" returns 
the student to the last decision point. It can be used for 


an unanticipated answer or for the path default. The author 
is asked to confirm the path terminator in all cases before 


the next command is accepted. 
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If. Ending a Segment 


As mentioned in path terminators, the ways to 


end a segment are with a "Goto", "Join", “Exit nal. ee 


"Repeat", As the path progresses, there 1S a number or 
"Main" to the left of the command line. This indicates 
which path the author is creating. For exampie “2.3008 


would indicate that the author is on the second path fron 
the main branch, the third path down the second route, and 
on the seventh branch from the third. Any time a default 
path is being built, the number terminates in a "D" ("ipa 


for example). 
4. diting a Segment 


There is no editing capability in the BUILDER 
program Similar to that of “TEX TEDeivomeo wir bo ele Changing 
or modifying a segment is either done py brute force 
{totally redoing the entire segment) or through use of 
files. The BUILDER command file (.TXT) can be edited using 
a text editor and then used instead of keyboard input. The 


command "File" gives the command line: 


——_— 





Breakpoint Comment Input 


Mabeiiimaenbines 


"Input" calls thas command file. If changes are necessary 
in the graphics or text files, but not in the command file, 
the author has to rebuild the segment but can use "File" to 


produce the command fiie. 


3) 


G. INTERP - TEST MODE 


ieee initial Steps 


When used in the test mode, INTERP is invoked by 
INTERP<RET>. There are no files created nor is any inforiaa- 
tion recorded in test mode. INTERP is 157K bytes and so it 
may not be possible to put the segment to be tested on the 
same diskette. When the lesson name to be tested is 
requested by INTERP, if other than the default (Same drive 
as INTERP), the actual location of the test segment must be 
specified. INTERP must have the four files generated by 
BUILDER (.RUN, ~PAG, .~GRF, and .TXT) for each Segment or the 
three files created by LINKER in joining segments together 
fon, -GRF and .~PAG). 

Upon invocation, INTERP asks for the lesson nane, 
and if tracing information is to be displayed. The tracing 
information shows the question and path number, and text and 
graphics frame number (not as created ir TEXTEDIT of 
GRAFEDIT, but numbered sequentially from the beginning of 


the segment). 
2. Segment Testing 


There are only two major differences between the 
testing and the final mode of lesson operation. One is that 
in the testing mode, the lesson management conditions 
Supplied by MANAGER.DAT are not available. The other is 
when a segment is called and is not linked to the seyment 
actually under test. INTERP returns a message stating 
"Calling segment" and continues tne segment being tested. 
It is therefore possible to test ail segments created Dy 
BUILDER, whether the segment iS a menu or control segment 
which calls other segments, cr the segment is a called 
segment. A correctly built segment operated under INTERP 
Should operate exactly as if it were being actuaiiv used by 


a student. 


see 


The segment being tested can be terminated either as 
specified by the author or in aless graceful manner by 


<ESC>. The escape gives the command line: 


a TESTI TTT SE = SSCSCSt*S~<SC<S;<SC=<S~Sséi‘s™S™S 
Resume Stop Backup Comment | 


= 


This escape mechanism is always available, even during the 


final mode, but it 1s intended as an emergency exit andasa 


means of ailowing student comment or backup. The <ESC> 
works when INTERP 1s waiting fcr a response. It will som 
work, for example, 1f INTERP is in the middle of a tined 


wait period or in the midst of a text or graphics display 


process. 


LINKER 1s invoked by LINKER<RET>. The author can 
specify only one control segment and eight called segments. 
It 1S possible to have a called segment itself be a ccntrol 
segment which calls other segments. Another possibility is 
uSing one version of the lesson as the control segment, with 
the called segments being corrected versions of segments in 


the “control” portion. 


2. Linking Segments 


When invoked, the first prompt in LINKER is for the 
host segment (or the control segment). The tollowing elLgie 
prompts are for called segments. Any or alli of the segments 
may be on a diskette in a drive other than the one occupied 
by the LINKER diskette. If less than eight calied segments 
are used, the author types <KET> to continue. The next 


prompt is for the name of the output segment, which may also 
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Bewplaced on a diskette different from.that of LINKER. ns 
there is already an output segment of the same name, the 
author is asked if it should te replaced. Segnent nanes 
only must be used - if a lesson name is used, the linking 
procedure will not work. LINKER displays the names of the 
segments as it is linking then. If one segnent calls 


others, they also are listed. 


3. Possible Errors 


If a segment cannot be found (for example, because 
of a misspelled name), LINKER returns and states that the 
segment cannot be found. If the file (lesson) name and the 
segment nhame are not the same, there may not be an é¢rror 
message, but when LINKER displays the names of the linked 
segments, the incorrectly named segment wiil not appear, as 
it has not been linked. If Something occurs to cause LINKER 
to terminate, and if there is no apparent reason for the 
termination, LINKER should be executed again. The author 
may need to enter the called segments in a different crder. 
The order entered in LINKER does not affect the final 


version. 


I. MANAGER 


MANAGER is invoked by typing MANAGER<RET>. It does not 
reguire the presence of any files. When MANAGER is invoked, 
the first prompt is "Using which directory?" IFt is best to 
use the same directory or disk drive upon which MANAGER is 
residing. If MANAGER.DAT 1s not present, it is created. If 
no reply file or 1f no student roster is kept, the initial 
MANAGER.DAT file is 6K bytes. 


> 


If there is a MANAGER.DAT file present in the directory, 


the command line is: 


Status Names Replies List Quit 


ee eee 





If MANAGER.DAT was just created, the system is placed inne- 
dvately into "Status. The default values for the lesson 


Management conditions in MANAGER are shown in Figure 3.9. 


SS Sa ee 
STALUS2> "Cie. > Ch er ee, | 
A. vaideodisk/7tape —S=— F | 
so elie = See 1% i 
G. record pathe-—-———_— | 
DD. ~UNanereipatedy —— aa 
Ee back -—————— Z 
FE... WSC FOSter- ==>] aa E 
G. use passwords —--- F 
He wSe student =LIRte=—-er 
lL. . USseeres fies —-_ ig | 
J. segment and frame 
K. string locaticns: | 
L. lesson nane: 

| 
i 





Figure 3.9 Manager Status Board 


They are changed by typing the letter of the line and then 
typing, exrther Cee sor 4 A "True" response means that 
lesson management condition is allowed. The lesson nane 
must be entered and it can indicate that the lesson resides 
on a disk or drive that is different from MANAGER.DAT. ie 
passwords, replies, rester or IL numbers are to be used, the 
author must supply then. The changes in "Status" are kept 


and the author 1S returned to the command line with <RED. 


The roster, ID numbers, and passwords are entered after 
invoking "Names", Replies are entered after invoking 
"Replies". "List" changes the student roster. When "Cui 
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is invoked, the author is First asked if the file 
(MANAGER.DAT) should be updated, and then if another direc- 
tory 1s to be done. The respcnse each time is "Y¥"<RET> or 
ay <RET>. 


Je INTERP —- FINAL MODE 


This is the final version of the tutorial as seen by the 
student. INTERP, MANAGER.DAT, and the lesson file specified 
in MANAGER.DAT must be present, although not necessarily on 
the same diskette. If any of the lesson management condi- 
tions have been specified and if the lesson itself is large, 
there probably will not be enough room on one diskette. 

The lesson can be invoked first by INTERP<FET>. ENT ERP 
Should be changed to something a little more descriptive cf 
the tutorial before it is presented to the student, however. 
Under the Microsoft Dos, this is done by "REN oldfile- 


name.extension newfilename.extension". 


fae LLIslTFRAM 


LISTFRAM is the program used to display text or grarhics 
frames at the terminal. Text frames can be converted fron a 


Mnon-ASCII file to an ASCII file which is suitable for 


pent ing. 

The program is invoked by LISTFRAM<KET>. The command 
line is: 
teers Per a eee a eee ee a lf 


| Text Graphics Quit 
a a ad cm ag a pc is et dp a ay 


When either "Text" or "Graphics" is selected, the procedure 
is the same. The next prompt is for the filename. The file 
may reside ona drive or diskette that is different fron 


ioir RAN. As LISTFRAWH is 70K Lytes, it 1s possible to have 


| 


the file to be listed on the same diskette as the listing 
progran. 


The next Gonmancaweline 1sS- 








rr aT ar ne 1 
| All Frame Getfile Help List Output Part Quit Segment | 
If there is more than one segment in the file, "Segment" 
must be invoked. “Part” lists —artworecnes a.ce The first 


prompt is for the starting frame number andthe second 
prompt is for the ending frame nuaber. WA11" starts with 
the first frame and lists all cf the frames in the segment. 
In either of these commands, the command line for each 


displayed frame is: 


San SEU na malcom me 
Next Frevious Quit 


CC. 


L. 


The clearing of the screen between frames is taken care of 
by LISTFRAM. 

"Getfile" 1s used to obtain another text or graphics 
file for dassting. It basically re-initializes LISTE Aga 
text or graphics listing mode, whichever was first selected 
upon invocation Vor LestrrRavi. To switch from liste 


graphics to text or vice versa, the author must return to 


the first level LISTFRAM command line. "Last" dis pia 
information on the file previcusly specified in the sane 
format wsed ih either DTEXTEDI) cr ckerepis. "Help",  aSsiaaa 
previously described VCIS prcgrams, displays a frame 


containing one line descriptions of LISTFRAM commands. 
"Frame" asks for one frame nusber and then displays that 
frame. 

At this time, only text frames can be printed out. The 


University of Utah programmers are working on a program for 


S18 


mies EM PC that will print graphics files. Text files are 


Peanted by invoking "Cutput". The new command line is: 


tec ene as oe ne i 


Console Disk 


ae 


os 


The author picks "Disk" and is then prompted for an output 
filename. This name may be the same as the TEXTEDIT file as 
the extensions are different. Selecting "Disk" changes the 
@eeault listing location for future LISTrRAM commands. Now, 
by invoking "All", the text file is converted and listed 
mito the disk. The actual printing is done after LISTFEA¥* 
has been exited with "Quit". The print command for the IB 


PC is "prn filename. extension". 


te, OURMARY 


This chapter has been included to provide the rfrospec- 
tive author with a basic knowledge of VCIS commands. Tt 18s 
not intended to replace the User's Guides, and  shouid be 
read in conjunction with the Guides. Pic. FOwlowinge Ghapter 
shows how this authoring system was used to create two 


Pucorials. 
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IV. CREATION OF VLSI TUTORIALS 


A. INTRODUCTION 


All of the VLSI computer-aided design (CAD) tools at the 
Naval Postgraduate School reside at present on the VAX 
11-780 operating under the Berkeley UNIX 4.2 operating 
system. As there were no short easy tutorials available for 
first time users to become acquainted with UNIX and one of 
its text editors, vi, it was decided that UNIX would be the 
first tutorial. This tutorial does not require the use of 
graphics and so eases the learning process involved with a 
complicated authoring system like VCIS. The second tutcrial 
then introduces the student to the world of VLSI - through 


its shapes, colors and notations. Graphics is a major 
POrtion of this tutor: The two tutorials together exer- 
cise most o£ the functions or options of VCIS. No video 


segments were used, as it was decided that the material was 
not suitable for video. A ccpy of the UNIX tutorial is 
provided in Appendix A and a copy of selected portions of 
the VLSI tutorial is in Appendix B. 


Be. LESSON PLANWHING 


1. Structure 


One of the first decisions made was to use a menu- 
driven structure. Students de not always have the solid 
block of time needed to complete one long seyuence of text 
and guestions, nor is it easy for them to start in the 
middie of a long sequence after a lapse of time. The menu 
allows them to choose to do those sections for which they 


have time, or which they wish to review before continuing. 
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A menu-driven structure also lends itself very well to divi- 
sion into segments which can be more easily built and 
modified. 

The VLSI tutorial has not only the main menu, but 
two embedded menus. The author decided that the amount and 
type of material would fit together better in this manner. 
The section on inverters, NAND, and NOR gates is a lengthy 
section if done as a whole, but is more manageable for both 
the author and the student when separated into three 


subsections. 
2. Questions 


The next decisions madé were on the type of gqués- 
Ons . The first tutorial on UNIX needed questions that 
reguired the student to actually perform the commands rather 
than memorize a response. This was achieved by using a two 
screen approach where the student lLogjed onto the UNIX oper- 
ating system at the same time he/she "booted up" the lesson 
on the IBM PC. The student was provided with a selection of 
files for practicing file manifulations, as well as text 
editing. | 

The second tutorial did not use guestions at all as 
it was decided since the guesticns that could be asked would 
be trivial, it would be better not to ask any. It was 
assumed also that a student doing this tutorial would also 
be taking a class in VLSI design and so would be doing 
problems/questions for the class. The format for the 
Shapes, colors and notations tutorial became that of Screens 
of text. The student is presented with a design problen 
upon completion of the tutorial that is intended to bea 


paper-and-pencil design checked by the instructor. 
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3. Assistance 


The first tutorial required that HELP be available 
for each command under instruction. There 1s no on-line 
help available in vi (the text editor) and while there is 
assistance in the main level of the UNIX operating systea, 
it would be disruptive to the lesson to have the student 
accessing it. As the student was not answering questions in 


the second tutorial, help does not need to be available. 


e 31) .Gak 
1. Zext Composition 


FOL both tutoervals- the text was edited to ensure 
that each frame was complete in itself with little need to 
refer to a previous frame. The author also ensured that the 
amount of text on the screen was not excesSSive. This istem 
particular importance in the VLSI shapes, colors and nota- 
tions tutorial where graphics cccupy a significant portion 
of the screen. 

The UNIX tutorials are designed to present the 
Minimum amount of knowledge a student needs to get on the 
system and do limited file manipulation. The student can 
either do selected sections for a bare minimum of knowledge 
or do the entire tutorial to gain knowledge of a few more 
complicated commands that do the same processes in another 
manner. It does not attempt to cover all commands or all 
options within a specific command, but is only meant to 
provide a means for the student to start on the UNIX. 

The VLSI tutorial follows 9 ket os ie This was used 
because the author assumed that the text used for a VLSI 
class would most likely be this one, and so would not 


present any conflict with material presented in class. 
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The principles and acticns for entering or changing 
text were the same for both tutcrials. A copy of the first 
tutorial is listed in Appendix A. Wherever possitle, the 
author attempted to maintain the tutorial text in seguential 
order according to segments. hat as, a scontrol Section 
(the menu) is done first, followed by sections called by the 


menu. Each section is preceded by a chapter title page. 


3. Attribute Selection 


The process of attribute selection was basically the 
same for both the UNIX and the VLSI tutorials. The only 
difference is that the attributes selected were different, 
as the author wanted to see the effect of different colcrs 
in the presentation of the material. 

When TEXTEDIT was first entered, the author edited 
the working set of colors to achieve a harmonious grouping 
SrecoOloOrs. Yellow, white and red were used as highlighting 
colors, with blue, green and gray used aS primary text 
colors. Gray was used in the VISI tutorial to contrast with 
the colors used to identify the various layers (for example, 
red is used for polysilicon). There was one set of colors 
used on the menu for cursor positioning instructions, and 
other colors for section names and selection instructions. 
Each frame had a section title at the top that was composed 
of one of the text attributes having a different background 
color from the rest of the frame (black was always used as 
the lesson background color). The £rame title for help and 
summary frames was done with a different attribute than the 
rest of the section to emphasis the nature of the frame. At 


least one color having an underlining was selected. 
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4. Text Input 


The process for text input for the two tutorials was 
exactly the same. The only significant difference was due 
to the use of graphics in the VISI tutorial. This necessi- 
tated constant checking between the text and graphics to 
ensure that nothing had been ccvered up and that the frame 
was nct crowded. 

A text frame was also created by overlapping previ- 
ously created frames. This was of particular use in the 


menu segments, where the only adaifference between one frame 


and another, was the section of the menu which had been 
highlighted. 
De ext Modifications 


As before the only difference between modifying text 
in the UNIX tutioriaijy sand. in Ssehe Visteon was the 
graphics used in the latter one. Large scale modification 
of text was not possible without constant reference to the 


graphics frame. 


D. GRAPHICS 


1. Object Selection 





The VLSI tutorial is the only one of the twe that 
uses graphics as a vital ingredient. It was not appropriate 
to use any graphics to describe UNIX. The objects selected 
for the VLSI tutorial were taken from [Ref. 3]. They were 
also chosen for their simplicity - both for ease in creation 


and ease in comprehension. 
2. Object and Frame Creaticn 


The basic unit of a graphics frame is the object. 


For example, the layout notation for an inverter was done by 
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successively choosing a colior and a pattern (overlapping 
Sera colors Jo net show underlying colors) and "Drawing a 


"Zone" or the desired size. Tne color and pattern Selection 


weme Gaetially done am "Status™, ‘Wereafter, requesting a 
Git herent "Style", temporarily altered the "Color" andor 
tae “Pattern. At certain tizes, the author stopped to 


designate what nad been "Create"d as an "Object". An object 
was named as such by the author when it could pe used to 
create another object. For example, an inverter (an object) 
with another input added became a NAND gate (another 
epyect) . Selected objects were created once and then roved 
Irom one frame to the next when needed. 

Atter each individual cpject for a given frame had 
eltner been created or obtained from a previous fraze, the 
Sere £lrawe was constructed by "Draw"ing "Object™s one at a 
time where needed. If the size was wrong, it was "Modiztived 
and “Zoon"ed larger or smalled as needed. It was also 
Pessable to "Ext"end (larger or smaller) an object in either 
mem vertical or aorizontai dimensions. ahen the frame was 
Go@piete, the author orly sawed objects actually used in 
that frame. One frame was kept as a liprary frame which 


GOmeained most of the basic onjects. 


3. Object and Frame Hodiftication 


ieee ae ne SS ee ee 


Eitner the frame or the opject ‘ere modified, 
Gemending on the degree of change recuired. if an obgect 
WwaS modified (size or color changed, for example), it ‘as 
Changed wherever it appeared on the irane. 

@pejcct avd D@rahereGodikicatiaen eee@picc a Large 
Peme ton Of the author's tine on the VLSI tutorial, as eacn 
time text changed, a corresponding Ccnange im the graphics 


was often required. 
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Es. BUILDING THE LESSON 


1. Using BUILDER 


The sequences used to ruild the two tutorials were 
essentially the same. In each the menu segments were [Luilt 
and tested first, fcllowed by the called segments. As 
mentioned previously, only the VLSI tutorial has grapes 
The VLSI tutorial also has emtedded menus but those were 
created in the same manner aS a main menu and linked in the 
same way. 

The lessons were usually created by "Display"ing 
first "Text" and then "Graphics" (except no graphics in UNIX 
EUEOE vdes). In those instances in the VLSI, tutorial where 
the graphics would have covered up the labels, the above 
order was reversed. The lesson either "Wait"ed for a 
certain period of "Time" or for a signal from the student 
(usually <RET>) before progressing on to the next stage of 
the lesson. Based on student surveys, the author determined 
that a Signal from the student was preferred, since reading 
rates varied as did the possibility of interruption. The 
"Clear Both" command froduced a rapid clearing of the screen 
and so it was used even when no graphics were present. 
("Clear Text" does so line by line while "Clear Both" clears 
the whole screen simultaneously.) 

When a frame asked a question or required a choice, 
a "Branch" point was needed. For example, when the student 
selects a section on the menu, it is done by "Position™ang 
the cursor. An invalid or "Unanticipated" response presents 
the same screen again and again until a correct response {in 
this case, a correct fosition) is obtained. 

Once a correct section was made, the author "Use"d 
another "Lesson_segment" (called a separately created 
segment). At the completion cf the calied segment, the 


student was returned to the main or section menu, with the 
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most recently completed section highlighted. The author 
briefly considered structuring the menu to postion the 
cursor on the next section on the menu after a given section 
was completed. This was not done, as the number of possible 
paths rapidly becomes unwieldy. 

In the UNIX tutorial, the student could choose to go 
ahead to the next frame, go tc a help frame and rarely to 
back-up to a previous frame. This choice was also provided 
through "Branch"ing by a certain "“Answer' provided on the 
"Keyboard". A "Right" answer got the indicated respcnse, 
while a "Wrong" or "Unanticirfated" answer repeated the 
frame. Each possible path at a "Branch" point was 
terminated properly. 

In the UNIX tutorial, when the student "Halt"ed the 
tutorial, the possibility for comment was provided and the 
PC would "Remember" the student comment. This appeared to 
cause some confusion with the students and so was not used 
ioeene VLSI tutorial. 

Each tutorial was tested by segment, menu-Linked 
segments, and in total. The menu control segments were 
tested before they were linked to the called segments. They 
showed correct operation if the statement "Cailing segment" 
was displayed when the USE statement was encountered. Each 
called segment was tested to show that it branched correctly 
at the desired points and responded properly to wrong 
answers. 

The menu segments were connected together eight ata 


time using LINKER. The author had to ensure that sufficient 


disk space was available to hold the completed lesson. The 
completed VLSI tutorial is too large (130K) to fit on the 
Same disk as all its component parts. When the segments 


were all linked, the completed lesson was again tested using 
INTERP. 
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After each tutorial had been tested, its MANAGER.DAT 
file was created using MANAGER. In the UNIX tutorial, ime 
only special lesson management condition requested was 
recording student path and respcnse. The VLSI tutorial used 
none or the special lesson management conditions provided as 
problems occurred that appeared to be linked to these 
functions. 

When complete, the command name, INTERP, was changed 
to something more descriptive of the individual lesson - 
VIUNIX ror the UNIX tutorial and SHAPES for the VLSI Shapes, 
colors and notation tutorial. The student then uses the 
name VIUNIX or SHAPES to do the tutorial. 


Fo STUDENT COBMENTS 


The author used a student opinion form on the first 
tutorial (see Appendix C) to help in the structuring of the 
second tutorial. Student comments on the UNIX tutorial were 
generally favorable. The authcr had asked guestions on the 
effect of colors in text and if waiting for a signal was 
preferred over automatic change of frames. The students had 
no comments or criticisms on color selection. They didy 
however, prefer the use of a signal to an automatic change 

< frames. 
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V. EVALUATION OF VCIS 


a ee eee —[——_ ae 


A. INTRODUCTION 


VCIS provides a flexible and comprehensive means of 
producing tutorials. The current versions of the programs 
are very user friendly. It is possible to learn the systen 
by using only the documentation and the help provided with 


each progran. 


Ewe onar lt DtT ° 


GRAFEDIT 1s a program that makes the creation and modi- 
fication of graphics frames easy and relatively painless. A 
feature that is especially nice, is the ability to change a 
GO2OLr or Patter ewithine athe ona wing context without 
suffering the disruption of going into the STATUS board to 
make the changes. Another welccme feature is the ability to 
cycle within the objects on a frame or within groups within 


an object during the modificaticn process. 


C. VCIS AVAILABILITY 


VCIS documentation lists several tmicro- ad masta = 
computers that can use VCIS. Tne author can speak fron 
experience on only two of these - the IBM PC {with Tecnar 


Graphics Master Color Board) and the VAX 11-780 with 
Berkeley UNIX 4.2 operating systen. The TBs PC version is 
vastiy superior to the VAX version that was available in the 
spring of 1984. 

Part of the problem is due to the time Sharing environ- 
ment of the 11-780, of course, and Cannot and srould not be 


Getorputed to VCIsS. The rest is dne to emphasis by the 
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University of Utah on the microcomputer versions of YCIS. 
This is an entirely valid perspective for this authoring 
system as the microcomputer environment 1S much more respon- 


Sive to the needs of the author. 


D. COLOR SPECTRUM CONFLICTS 


At present, the most annoying problem lert in VCIS, and 
it is admittedly a minor one, from the author's point of 
view, is the discrepancy between the colors when viewing a 
frame produced by one program in the context of another. 
The color spectrum has eight darker, more vivid colors on 
one side and eight lighter colors on the other side (16 
colors on an IBM PC with Tecmar Graphics Master Coior 
Board). The order (iight vs. dark) varies from program to 
program. There are two examples of this. Tne first example 
is the creation of a graphics frame using a dark vivid red 
and green. When this frame 1S viewed by either TEXTEDIT or 
BUILDER it appears as a pale red and green, and when seen in 
the final product (INIBRP), is back to the colors in wage 
the frame was created. The second example is in TEXTEDIT, 
where the author must take care to select, for example, a 
light blue foreground without underlining anda dark blue 
foreground with underlining, in order to present a uniformly 
light blue foreground in the final product. Neither of 
these problems 1s monumental, both are correctable, but 
together they represent a constant irritant to the author, 
who 1S never gquite sure what the graphics or text frame 
really looks like. The University of Utah Computer Science 
Department iS aware of this proklem and it wiil be corrected 
in subsequent versions of VCIS. 

Another color problem, which is a matter of taste rather 
than actual error, 1s the color selection in TEXT=EDIT. With 


16 possible colors (on the IBM PC uSing the TECNAR Graphies 
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Master Color Board), there are a number of color combina- 
tions provided that are probatly unusable. Manygewor -the 
lighter colors {light blue and light green, for example) are 
not visible against other lighter colors. inpado1t 20n, =) Gbie 
author can visualize no usage whatsoever for a foreground 
and a background of the same color (the letters are not 
visible). Again, the University of Utah programmers are 
aware of this and the color combinations will be rearranged 


to avoid the less usable combinations. 


E. LINKER 


The current version of LINKER generaily performs as 
reguired. It links one control segment and up to eignt 
called segments. However, the author encountered one 
totally unexplainable situation when the order of the calied 
segments came into guestion. The order should not matter as 
LINKER should simply continue for the author-Supplied list 
of segments until the next segment reguired by the control 
has been encountered. Theweauvthon's. «actual and correct 
sequence of segments was, after the main control segment, an 
embedded menu with called segments, a normal segment, an 
embedded menu with called segments, and two more normal 
segments. LINKER continued to fail with errors indicating a 
problem within the normal segment locatec between the two 
embedded menus. The author relinked the menu segments, 
rebuilt the normal segment and reran LINKER witnout success. 
A University of Utah frogrammer suggested changing the order 
of the segments as given to LINKER which would not affect 
the final lesson order. The new order, which worked 
successfully, was the two embedded menus, followed py the 
three normal segments. While changing the order was an easy 
solution to the problem, it was not necessarily obvious from 


the error messages received. 
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F. NAMING CONVENTIONS 


BUILDER requires the use of both a seyment name anda 
lesson name. It would seem reasonable to have one lesson 
name and possibly several segment names. A segment name and 
a lesson name must be the same, as the oniy name under which 
the file is stored is the outer or lesson nane. Reuse of a 
lesson name, even with a different segment name results in 
destruction or change to the previous segment. LINKER aiso 
uses segment names rather than lesson hameS during the 
linking process. The documentation on VCIS does tell the 
author to use the same name for both segment and lesson, but 
it creates minor author confusion to have two different 


labels for the same name. 


G. MANAGER 


MANAGER provides many potentially useful lesson manage- 
ment conditions. It provides the ability to monitor student 
trouble spots by recording their paths through and responses 
to the lesson. Unfortunately, the progran to read _ the 
student responses and paths is not yet available. Le 
students make comments or continue to experience difficul- 
ties in the same areas, they aust still contact the 
instructor as MANAGER, at present, has write-only 
Ca pa oda vc 

When the path or response recording function is used, 
the diskette obviously cannot be write-protected. Wniie 
Many students are responsible and probably would not jielib- 
erately seek to destroy a lessen, the possibiity for inad- 
vertent destruction exists. The student has the frustration 
of not knowing exactly what has occurred and must obtain new 
lesson diskettes from the instructor. Exactly this sigue 
ation occurred more than once with the UNIX tutorial. The 


author, therefore decided, that while recording student 


i2 


paths and responseS waS a very useful lesson management 


concept, the concept was not yet ready for actual asage. 


H. OVERALL COMMENTS 


The author found the VCIS authoring system to be a very 
Steective means of producing a high quality product. The 
Support rendered by the University of Utah staff was magnif- 
icent, with questions answered and solutions to probiems 


provided aimost instantaneously. 
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APPENDIX C 
SYSTEM REQUIREMESTS AND LCGON PROCEDURE FOR VCIS 


1. Diskettes 


The IBM PC with VCIS uses double sided double 
density 5 1/4 inch floppy diskettes. TEXTEDIT, GRAFED Ew 
and BUILDER each should have their own diskette due to their 
size. INTERP and MANAGER can reside on the same diskette. 


CHEDIT, LISTFRAM, and LINKER can aiso reside on the same 
floppy. 


A. Turn onthe disk drive. The orange power switch is 
located to the right and near the back of the disk drive 
unit. Then turn on the monitor. 

B. The booting disk should ke inserted label up in the 
leftmost or upper disk drive, aliso known as drive 9 or drive 
A. Where the location of drive 0 is, depends on the config- 
uration of the systen. 

C. If the booting disk is not inserted before the IBM FC is 
turned on, depressing <CONTROL>, <DEL>, and <ALT> sinultane- 
ously will boot the systen. 

Ds Rarely, booting the system does not clear the screen or 
produce the logon text. At this point, the user must turn 


the disk drive unit off for a few minutes and then re-boot. 


sie A successful booting will ask fer the current date and 
the current time. If desired, they must be entered as in 
the sample on the screen. If no data or time needs to be 


attached to the sessicn, typing <RET> twice cycles the user 
past this block. 
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F. The booting or system disk that comes with the Microsoft 
Weee2-0 will not work with VCIS-; VCIS restructures the 
keyboard in a certain manner, which is not done by the 


standard booting diskette. 
3- logging off 


Provided that either the tutorial authoring session 
is complete, or that the tutorial execution is over, and the 
drive prompt has been displayed, the user may logoff simply 
by removing all diskettes and turning off the power switches 
previously mentioned. Removing the disks while the disk 
drive 1S moving is an emergency measure only and should be 


avoided if at all possible. 


4“. Executing The VIUNIX Tutorial 


Ne Boot the system using the disk labelled "Tecmar booting 
disk". The prompt is "A>", 

feueowatch to 5 drive by typing “b:<RET>". 

C4 Insert disk labelled "Viunix tutorial" or "VLSI Shapes 
tutorial" label up into fright or lower drive. Type 
"vyiunix<RET>" or "shapes<RET>", depending on which tutcrial 
is being executed. There will be an initial flurry of 
colors/shapes. The tutorial 1s seif-explanatory after this. 
De If the user needs to leave the tutorial and is ata 
decision point (input is required the user), type <ESC>. 
The prompt is "Resume Stop ", hype only. Ss" “(or "KR" at the 
user has changed his/her mind). DeomnOtentt pfretirn’= only 


the letter is necessary. 


Eee Generally, if the user types in something very wrong, 
nothing should happen. The tutorial will wait at that 
screen until a correct responsé€ is entered. If the user 


inputs a misspelling that is at least 75% correct and suffi- 
ciently different from another correct response, the tuto- 


rial continues on what is assumed to be the correct path. 
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For example, if the possible responses 
UNEXX™ OF 9 "MEX TS yaeieewoLk, Joublos gap. Gae 
could be either "NEXT" (or ““HEie A 
response must be 100% correct, cf course. 


are "NEXT HELos 
will not aS that 


Single character 


F. Logoff the PC using the procedure described previously. 
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APPENDIX D 


= a SE ee ee et ee 


Plesk, MOTs 
TUTORIAL SURVEY 
WZ OCICBER 304 
J. EXPLANATION. 

THIS IS ONE IN A SERIES OF TUTORIALS ON VLSI DESIGN AND 
ASSOCIATED REQUIREMENTS. i HOULD LIKE YOUR 
SUGGESTIONS/FEELINGS/COMMENTS ON A VARIETY OF AREAS. 

2. TIMED FRAMES. 

THERE ARZ SEVERAL FRAMES (USUALLY AT THE START OF A 
TUTORIAL) THAT ARE VISIBLE FOR A SET AMOUNT OF TIME. PLSASE 
COMMENT ON THE AMOUNT OF TIME - IS IT ENOUGH OR IS IT 100 
MUCH TIME? WOULD IT HAVE BEEN BETTER TO HAVE BEEN ALLOWED 
TO CONTINUE WHEN READY RATHER TEAN HAVING A TIMED FRAME? 

Z- MENU. 

IS THE USE OF THE MENU CLEAR? _ WOULD ANOTHER METHOD HAVE 
BEEN BETTER OR LESS CCNFUSING? IF YES, PLEASE EXPLAIN WHERE 
THE CONFUSION EXISTS AND WHAT COULD BE DONE TO IMPROVE IT. 
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3. USE OF COLORS IN TEXT. 

WERE ANY OF THE S2CGLORS UStt2 
UNNECESSARY? Mie 
EXPLAIN WHY. 


THE TEXT IRRITATING OR 
YES, PLEASE IDEDTIFY THE FRAME(S) AND 
| 


4. GRAPHICS. 

AS NOT ALL THE TUTORIALS USE GRAPHICS, PLEASE SKIP fie 
SEGLION ITF 22 DOS NOt Are. 
ik 


WERE ANY 2 r GRAPHI 


ea et CS CCNPUSING? Ne) Ba sy PLEASE 
IDENTIFY THE FRAME(S) AND EXPLAIN WHY. 


WERE THERE ANY FRAMES owned CONTAINED TOO MANY 
ILLUSTRATION SE IF YES, PLEASE LUDENTIFY THE RANE Cs) See 
WHICH ILLUSTRATIONS SHOULD BE REMOVED 





5. SUMMARY FRAMES. 
Pees THE MOUMNMARY FRANES ADEOUATE- SHOUD heer NORE OR 
feo INFORMATION ON THEM PRE ase DENTEIFY THe FRAME{S) AND 
Seen i HOW THEY COULD BE IMPROVETL: 
6. DUAL SCREEN PRESENTATION. 
DUAL oC REEN PRES ENIAD JON eS NOT Se OeON Al. LUBORIALS. 
Breast SKIP THIS SECTION IF IT COES NOT APPLY. 
Mo LHE DUAL SCREEN PRESENTATION EFFECTIVE? WOULD IT YAVE 
Been BETTER TO HAVE USED ONLY ONE TERMINAL? 
Hee) SIIPELE PLOTS. 
PeePe PLE ePLOIS ARE NOT AVAILAELE ON ALL TUICRIALS. PLEASE 
epee THiS SECTION IF IT DOES NOD APPLY. 
Poe cOUeErIND THE] STTPPLE PLClS USEFUL/JEFFECTIVE? wOULD 
YOU HAVE WANTED MORE OR FEWER PILOTS? 
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